Remove Items from List

Route

/v2/lists/{list_id}/items

Description

Remove specific values from an existing policy configuration list. Values that don't exist in the list are ignored.

Method

DELETE

Inputs

Parameter	Type	Required	Description
list_id	string	Yes	Unique identifier of the list to remove items from
values	array[string]	Yes	Array of values to remove from the list

Path Parameters

• list_id: The unique identifier of the list (provided in the URL path)

Request Example

{
  "values": [
    ".tmp",
    ".old",
    ".bak",
    ".log",
    ".cache"
  ]
}

Output

Field	Type	Description
removed_count	integer	Number of values successfully removed
not_found_count	integer	Number of values that were not in the list
total_values	integer	Total number of values in list after removal
removed_values	array[string]	List of values that were actually removed
not_found	array[string]	List of values that were not found in the list

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response

{
  "removed_count": 3,
  "not_found_count": 2,
  "total_values": 15,
  "removed_values": [
    ".tmp",
    ".old",
    ".bak"
  ],
  "not_found": [
    ".log",
    ".cache"
  ]
}

Usage Notes

• Maximum 100 values per request
• Values that don't exist in the list are ignored
• Values are case-sensitive
• Empty or whitespace-only values are ignored
• Cannot remove all values from a list (minimum 1 value required)